home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Sound / MIDI / MIDI Utilities / CMU Midi Toolkit / ReadMe.txt < prev    next >
Text File  |  1988-03-24  |  5KB  |  174 lines
  1.  
  2.  
  3.                 Carnegie-Mellon University Midi Toolkit
  4.                     Macintosh Version -- PRE-RELEASE
  5.  
  6.                            Notes and Cautions
  7.                               March 6, 1987
  8.  
  9.  
  10. 1. This is a Pre-Release -- Buyer Beware!!
  11.  
  12. The CMU Midi Toolkit (CMT) is distributed for essentially the cost of
  13. reproduction and mailing. It comes with no guarantees but all source
  14. code is provided and users are invited to fix bugs and add features
  15. as they see fit. This is a PRE-RELEASE of the CMU Midi Toolkit for the
  16. Macintosh and thus we can make even fewer claims of correctness and/or
  17. suitability. What is more, you will notice many discrepancies between
  18. the "Charles Ives" edition of the manual, written for an older version
  19. of the system implemented on an IBM PC, and this version which runs on
  20. the Macintosh. Despite all this, we hope you will find this software
  21. useful in your musical work and that you will bear with us until we get
  22. time to put the finishing touches on.
  23.  
  24. 2. Getting started
  25.  
  26. Pre-built applications are supplied for Adagio, DXGet, and DXPut to help
  27. you get going. Also, a number of demo songs have been supplied. You may
  28. wish to glance over the manual before you get started. Some of the remarks
  29. in the remainder of this document will assume you have some familiarity
  30. with the manual.
  31.  
  32. The user interface for this verion of Adagio is somewhat different from
  33. that described in the manual. Type "?" to Adagio to see the possible
  34. commands. Although the manual discusses programs called Transcribe and
  35. Record, these functions have been subsumed by the Adagio program. Each time
  36. Adagio "performs", it may play a pre-existing score, record midi events
  37. performed live, or do both at once.  A prompt will ask you which of these
  38. tasks you want to perform.  At any time you can pop out to the top level
  39. command and choose a different task.
  40.  
  41. Admittedly, this user interface may be more daunting for beginners but
  42. it allows you to switch between recording and playing back things you've
  43. recorded without switching applications, which is quite slow on the
  44. Macintosh. (You will still have to leave the application and use a text
  45. editor, however, to combine a number of separately recorded tracks into
  46. a single Adagio score.)
  47.  
  48. 3. Building the tools
  49.  
  50. The system was build using the Lightspeed C compiler, version 2.01. (If
  51. you have MPW C, see note 5 below.) At the top level of the folder, you
  52. will find all the projects which may be built. The projects are:
  53.  
  54.     AdagioProj -- play, record, or record while playing
  55.     DXGetProj -- receive DX7 or TX816 configuration data and save in a file
  56.     DXPutProj -- transmit saved configuration data to a DX7 or TX816
  57.     MMProj -- monitor midi activities
  58.     MoxcProgProj -- Moxc testbed; copy this project and modify it
  59.     MoxcEchoProj -- Moxc "echoes" program demonstration
  60.     TuneProj -- builds .tun files (not well tested!!)
  61.  
  62. The object code has been removed from the projects to save space, so you
  63. will have to recompile everything before you get started.
  64.  
  65. 4. Using Moxc
  66.  
  67. There is a slight quirk about Moxc due to the way Lightspeed C handles
  68. libraries. The MoxcProgProj project includes a complete set of Moxc
  69. functions, including default handlers for all events. When you supply
  70. your own handler for a particular class of events (e.g. midi note inputs),
  71. Lightspeed C will tell you that the handler is multiply defined. You merely
  72. remove the module containing the default handler from the project (use
  73. "Check Link" to find out which one) and go on. Of course, if you decide
  74. to remove your custom handler you will have to restore the orginal default
  75. one. You might wish to keep the original copy of MoxcProgProj intact as a
  76. starting point for exeriments with Moxc. All source and header files specific
  77. to Moxc are kept in a separate folder.
  78.  
  79. 5. Building CMT using MPW
  80.  
  81. CMT was first ported to the Macintosh using the Macintosh Programmer's
  82. Workbench C compiler. It is probably still possible to build the entire
  83. system using MPW C, but you will have to construct your own make files.
  84. Be sure to change the appropriate defines in "switches.h" to select MPW.
  85. You will also have to assemble and link in the file "macintr.asm".
  86.  
  87. 6. List of files
  88.  
  89. Adagio
  90. AdagioProj
  91. DXGet
  92. DXGetProj
  93. DXPut
  94. DXPutProj
  95. MMProj
  96. MoxcEchoProj
  97. MoxcProgProj
  98. ReadMe.txt
  99. TuneProj
  100.  
  101. :Includes:
  102.     adagio.h
  103.     cext.h
  104.     cmdline.h
  105.     excldesc.h
  106.     filestream.h
  107.     memstream.h
  108.     midibuff.h
  109.     midicode.h
  110.     mididriver.h
  111.     midiparse.h
  112.     mpu.h
  113.     noteoff.h
  114.     phase1.h
  115.     phase2.h
  116.     pitch.h
  117.     record.h
  118.     stream.h
  119.     switches.h
  120.     userio.h
  121.  
  122. :'Moxc Stuff':
  123.     cmtprog.h
  124.     echoes.c
  125.     moxc.c
  126.     moxc.h
  127.     moxcasci.c
  128.     moxcbend.c
  129.     moxcctrl.c
  130.     moxckydn.c
  131.     moxckyup.c
  132.     moxcpddn.c
  133.     moxcpdup.c
  134.     moxcprgm.c
  135.     moxctest.c
  136.     moxctouc.c
  137.     prog.c
  138.     retune.c
  139.     userfns.h
  140.  
  141. :Songs:
  142.     allemande.gio
  143.     babylon.gio
  144.     bach.gio
  145.     bouree.gio
  146.     song1455.gio
  147.  
  148. :Source:
  149.     adagio.c
  150.     cmdline.c
  151.     dxget.c
  152.     dxput.c
  153.     excldesc.c
  154.     filestream.c
  155.     macintr.asm
  156.     macmidi.c
  157.     memstream.c
  158.     mididriver.c
  159.     midiparse.c
  160.     mm.c
  161.     nointdriver.c
  162.     noteoff.c
  163.     phase1.c
  164.     phase2.c
  165.     record.c
  166.     tuning.c
  167.     userio.c
  168.  
  169.  
  170. Happy music making!!!!
  171.  
  172.     -- John Maloney, March 6, 1987
  173.   -- and Roger B. Dannenberg, March 23, 1988
  174.